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1.0 INTRODUCTION 


The Network Interconnect Exerciser (NIE) provides online diagnostic 
exerciser for Ethernet networks. The NIE determines node oe on the 
network and provides the operator with error analysis. Node installation, 
verification, and problem isolation can be performed using the NIE. 


The NIE is device independent. The NIE will run with any Ethernet device 
that can be accessed using the DLX interface mechanism. Also, the NIE may 
be run on RSX-11M+, 11M and 11S systems. 


NOTE: 
The DLX (Direct Line Access) interface was designed to 
enable user programs to use direct, nigh loves interface 
to a physical line protocol yypece ine. he higher level 
layers of DECnet. The RSX JEUNA/DELUA QIO Driver uses 
this interface to communicate with user programs. 


The RSX online NIE may be used in the following configurations: 


With DECnet 
The NIE runs enpmnrentiy with DECnet software. The NIE uses two 
NI protocol “ee: oopback and remote console. The NIE 
interfaces to Cnet vie the Direct Line Access (DLX) 
functionality of DECnet. NIE communicates with the DECnet 
Ethernet driver via the NX: pseudo device driver. 


Without DECnet : 
The RSX online NIE can be run using the RSX stand alone DEUNA 
driver. This configuration was provided for systems wothout 
DECnet. DECnet may be present, however, the Ethernet device to be 
used may not be accessed via DECnet. The NIE was developed wine 
the RSX stand alone DEUNA driver which implements the DL 
interface used by DECnet. 


Node table on disk or in memory  _—_ 
The node table may be built on disk into a temporary file. Using 
disk, the nodestable may have up to 1024(10) entries. The maximum 
eo @ memory resident node table is around 70(10) node 
entries. 





2.0 BUILDING THE NIE 


NOTE 
DEV: (USER-UIC] refers to device and VIC where the files 
were copied to from the distribution kit. 


ee 





—— 
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68 al 
169 
+t 2.1 NIE BUILD PARAMETERS 
172 
173 {1 1 IMETLIS: MLB 
174 If the network macro library is not present_in account [1,1], the DECnet 
175 enrtinees are not built into the NIE. The absence of this file will 
176 define NONETL=0 in prefix file D.MAC. If NONETL is defined, the network 
eH related code will not be included. 
179 M$$NET 
180 If not defined in [11,10)]RSXMC.MAC, the DECnet interfaces are not built 
181 into the NIE. 
182 
183 R$$11S 
184 If defined in (11, “igen MAC, all code concerned with disk storage is 
185 conditionalized out 
186 
187 
189 
ioe 2.2 PROCEDURE TO BUILD THE NIE 
192 —_ 
+ NOTE - The build command file uses the following non-NIE files: 
195 SY:[11,10)]RSXMC .MAC Required RSX macro prefix file!!! 
196 Mss $NET is in this file when defined 
197 $$11S is in this file when defined 
198 SY: (1, sinete re MLB ; Not required. If not there no DECnet 
199 ; interface code will be generated. 
$90 SY:(1,54)RSX11M.STB ; Required to build NIE 
20 
$25 Magnetic media contains the following files: 
Soe CZNIA.SEQ ; NIE documentation file. 
rd NIEBLD.CMD ; NIE ag command file, used to build 
209 DEUNA.MLB + DRAEthernat aecres (required for beth 
st? ; NIE and XE: Driver 


The following are NIE macro files 
NIESUP .MAC ; NIE s 
UB . MAC 







rt task code 


NIESUB. ; NIE t subroutines 

NIECMD . MAC ; NIc task command processing routines 

NIEPRS . MAC ; NIE command parser modules and data 
; structures. 


The following are XE: (DEUNA/DELUA) Driver files. 


— _ 
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227 

228 XEDRV .MAC ; XE: Driver c 

229 XETAB .MAC ; XE: Driver Rex Database 

230 UNAMC . TSK ; XE: Driver DEUNA ECO microcode file 
$33 LUAMC . TSK ; XE: Driver DELUA ECO microcode file 
233 

S36 Building command sequence: 

236 

$34 DEV: for Magt 

or = 

239 DEV: for Dee = Dux:(3.3) 

241 >MOU DEV:NIE ; Mount vig org a kit 

242 >PIP /NV=DEV:CZNIA.SEQ ; y documentation file 

243 >PIP /NV=DEV:NIEBLD.CMD ; Cop 4 NIE build command file from distro kit 
$46 >A@NIEBLD ; Do the build 

$3 Answer questions asked by build command file. 

248 saa NOTE «00 

Son See APPENDIX A for sample build print out! 

sa 

$39 2.3 INSTALLING NIE 

$25 

256 NIEBLD.CMD will do the installation at the end of the build. However, if 
TH the system is re-started, the folowing must be installed: 

59 MCR>INS (USER-UIC JNIE 

t' MCR>INS [USER-UIC JNIi 
se NOTE 
263 The XE: driver must be installed (LOADED) if a 
Pe non-DECnet system is being used. 
266 
267 
soe 3.0 RSX QIO UNA DRIVER BUILD 
270 
271 The following command lines will assemble the driver code and the driver 
] RSX database: 
on Assemble driver code - 
276 (11, 24 )xedrv.{11,34]xedrv/cr/-sp=[1,1]Jexemc/ml, dev: [user-uic]d, - 
sii deuna/ml,[11, 10] rsxme/pa: 1,dev: \ueee- uic)xedrv 
$03 Assemble driver RSX data base - 
281 ([11,24)xetab,[{11,34])xetab/cr/-sp=[1,1]exemc/ml, - 


" 
+ 
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deuna/ml1,[{11,10]rsxmc/pa:1,dev:[user-uic])xetab 


3.1 RSX QIO UNA DRIVER PARAMETERS 


The following parametes = 3ef defined 2 te 
in 

D.MAC fits a be set 

redefined 


These parameters will fined 


vases for these parameters in the 
The perevet garers will be 
sy: ‘fil. 10 )JRSXMC.MAC. 


NOTE 


Rormai by. there should be no reason to define/redefine 
these parameters for eat vo XE Driver! 
ere 


parameters are presented 


purposes. 


The following are default definitions: 


U$ $NCT=1 ; 
oor ed ; 


USSNTS=3. 


3.2 BUILDING XE: THE DRIVER 


ER-UIC JNIEBLD.CMD 


The wOteax 
ona USER. UIC ]XEDRVBLD.CMD command File. 


to build the X driver. 
3.3 INSTALLING (LOADING) THE DRIVER 
RSX1L1M-PLUS 
MCR>CON SET VEC=vvv CSR=xxxxxx 
MCR>CON ONLINE XEA,XEO: 
MCR>INS UML 


RSX11M 
MCR>LOA XE:/PAR=PARTION 
MCR>INS UML 


:(11 510 JES -FAC file. 
pref ix file also. The 
to the default. 
definitions in 


mat 


by their 


The 


or documentation 


Number of controller on system 
Number of ports per controller 
; Number of receive ring entries 


r of transmit ring entries 


and ~—=—_s fille will rate 
This file contains the TKB lines 


; Set vapor and CSR 

; Set and controller online 
; Install  OEUNAS DELUA microcode 
; .. loader support task 


; Load driver 
; wale DEUNA/DELUA microcode 
; .. loader support task 


CZNIA 
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4.0 NIE COMMANDS 


NOTES 
Notation in left and right square brackets is optional. 
i.e. - M{ESSAGE) /TY([PE)=ASCII<CR> 
is equivalent to 
M /TY=ASCII<CR> 
Also, spelling errors in optional text are ignored. 
i.e. - MEZZAGE /TYTE=ASCII<CR> 
will be parsed to mean 
M /TY*ASCII<CR> 


4.1 HELP 
A help File showing a summary of NIE commands can be displayed by t 
“Help” or “H" in yGenanes fe the NIE prompt. For inom: 4 y typing 
NIE>he[ 1p] 
or 
NIE>? 


4.2 EXITING THE NIE 


The Exit command exits the NIE task. There are no switches or qualifiers 
for the Exit command. The format is: 


NIE>e[xit] 


4.3 BUILDING A NODE TABLE 


The current node table is a data structure which the NIE uses to determine 
which nodes are available for testing. When the node table is saved on a 
disk file, it is saved in ASCII format to allow the node table data to be 
examined off line. In addition, the saved node table disk file includes 
the logical node names. 


wee | 


K1 
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Data in the node table includes the following: 
1. Current node physical address. 
2. Default node physical (hardware) address. 


3. NIE assigned logical node address. Node data can be accessed via 
the NIE assigned logical address. When the node table is saved 
in an ASCII text file the logical node addresses are also saved 
in ASCII format. 


As nodes are added to the node table the NIE assigns logical 
addresses in the sequence nil, n2, n5,...,etc. In cases where 
some nodes have been removed there may be a gap in the logical 
addresses. In _ this case when new nodes are added their logical 
addresses are first assigned from the gap. For example, if the 
current node table has logical addresses nl, n2, and n5 assigned, 
a oN would be assigned logical addresses n3, n4, ‘ 
n scoco® Ce 


4. DECNET address. Phase 4 node addresses have the DECnet address 
Carea.node-number) encoded within the current physical address of 
the node. The DECnet address is displayed for phase 4 nodes. 
For non-phase 4 nodes “UNKNOWN” is displayed in place of the 

DECnet node address. 


3. Node device type. (i.e. - DEUNA, DELUA, etc.) In some cases the 
node device type may not be known. 


4.4 BUILD COMMAND 
The build command builds the node table by listening to system ID messages 
sent out by each node in & minute intervals. 
Command format is: 
NIE>BU[uild) [/m[ in)=xxx) 


Where the switch /MIN is an optional switch to pg ah the 
number of minutes to wait before the build is terminated 
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4.5 SAVING THE CURRENT NODE TABLE 


pe seve command will save the contents of the current node table. The 
format is: 


NIE>s=xi ve) 





device is used the node table is saved in [1,2)NIE.TBL 
can be printed or viewed using the editor. 


e@ mass stor 
frie. The file 


NOTE: With this version of the NIE you cannot specify a file name to be 
used for the save file. The ele name is forced tobe. sy: 1, 2 NIE. TBL. 


When not union 2 8 es _ sterene media, the current node table is copied to a 
secondary os table then can be modified without distroying 
the oriaical node tab 








4.6 UNSAVE 


The unsave command will restore the contents of the node table. If a disk 

is used by the NIE, the node table is restored from [1.2)NIE. TBL file. If 
no disk is yood by the NIE, the secondary buffer is copied over to the 

or iene buffer 

NOTE: With this version of the NIE you cannot specify a file name from 

which to do the unsave (restore) from. 

The command format is: 


NIE >u[nsave] 


4.7 SHOW 


The Show command will print the physical addresses of nodes selected for 
test i59 and the message paramaters to be used (either default or operator 
The format is: 
NIE>show <argument> 
1.@. - 
NIE>sh[{ow] nlodes] ; Will dispaly the node table 
NIE>sh[ow]) m{essage] ; Will display message parameters 


—— 





CZNIA 


VUMIUIUNIUIUINnua 
BIR SUH O 


SSSLG 
WNMrOow 


ea So SBA S33 


wa 





- RSX ONLINE NIE MACRO M1200 10-JUL-85 14:24 PAGE 11 


Page 11 


NIE>sh[ow) clounters] ; Will display counter information 


There can be three arguments for Show. They are: Nodes, Messages, 
Counters. 


The Show Nodes command lists all nodes in the Node table. The list will - 
include the default physical address, the current physical address a 


logical address assigned to the node by the exerciser. The rf can 
referenced by either of the physical addresses or the logical address. 
Logical addresses will be assigned as ni, n2, n3,..... etc. 


NOTE: 
The node table display can be stopped with any character 
from the keyboard. 


The Show Messages command will list the message type, message size and the 


number of copies to be sent which are currently selected. Also the 
Print/Noprint status will be displayed indicating the error message output 


The Show Counters command will list the counter contents of the host node. 
EXAMPLES: 
NIE>show message 


MESSAGE PARAMETERS ARE: 
SIZE=292 , COPIES=1, PRINT 





THE CURRENT 
TYPE=ASCII , 


NIE>show nodes 


“ 


CURRENT ADR DEFA DR NAME DECNET DEVICE 
AA-00-04-00-0A-10 AA-00-03-00-00-01 NO 4. DEUNA 
AA-00-04-00-1B-10 AA-00-03-00-00-02 Ni 4.27 DELUA 

00 03-00-00-03 ; DECNA 
AA-00-04-00-9C-10 AA-00-03-00-00-04 N3 4.156 DEQNA 
NIE>show counters 
ETHERNET COUNTER SUMMARY 
SECONDS SINCE LAST ZEROED : 13257 

RECEIVED 7 
















PACKETS : 9184 
MULTICAST PACKETS RECEIVED : 81793 
PACKETS RECEIVED IN ERROR (BIT MAP) : 0 

DATA BYTES RECEI : 10491573 
MULTICAST BYTES RECEIVED : 9915460 
RCVS LOST - INTERNAL BUF ERROR : 46 

RCVS LOST - LOCAL BUFFER ERROR : 

PACKETS TRANSMITTED 12601 
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MULTICAST PACKETS TRANSMITTED 
PKTS XMITTED on 3° COLLISION 
PKTS XMITTED WITH 2+ COLLISION 
PKTS XMITTED BUT DEFERRE : 169 
BYTES TRANSMITTED : 1131157 
MULTICAST BYTES TRANSMIT : 406378 
TRANSMIT PACKETS ABORTED. (BIT MAP) : 0 
TRANSMIT PACKETS ABORTED COUNTER : 0 
XMIT COLLISION CHECK FAILURE 








: 2675 
: 13 







4.8 RUN 










RUN command performs the_ specified test on all 
entries of the node table. iii's may cause @a°~ $n 
Extended LANs (multiple LANs connected by Bridges). 
This means that running a test on all nodes in the node 
table may not se that the LAN in question has been 
properly tes The table may not even contain 

all the nodes on the LAN in question. 


Also, on large LANs, running tests against all nodes on 
the g be prohibitive. 

































network 


The run command will cause the execution of the test epesiies by the 
argument. The results of the RUN command are used to update the Summary 
log as well as to output error information. The format is: 











- NIE>r{un) <argument>/pass=nm 
The argument for Run can be either D[irect], Plattern], Llooppair) or All. 
The qualifier Pass=nn will allow the rator to select the number of 
for the particular test se acter, ae -1 is speri Pies for the 
ount the test will run SONS UOUS EY ne gasecoun is specified, 
pesscount defaults to the passcount a i with the ecm command. 
The following are standard NIE data patterns: 
ASCII - The ascii data pattern. 


2. ONES - A pattern of all binary i's. 





















3. ZEROS - A pattern of all binary 0's. 

4. iALT-A goers 7 alternating binary 1's and 0's starti 
with 1 (1010.. ™ , ” 

5. OALT - ttern of alternating binary 0's and 1's starting 


with 0 fo _ Fe 2 
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6. CCITT - The ccitt data pattern PDP-11 assembler format. 


ASCIDATA: : 


;ASCII alphanumeric data pattern 


.ASCIT Ne Sed ( )a+, -/012345\ - 


COEF GHIJ\ - 


q2>7: 
XKLANOPORS TUVIKYZ( abe 
thy fc laneperetuveny\- 


CCITTDATA: : 





EXAMPLES OF RUN COMMAND OUTPUT: 


NIE>run direct 


DIRECT LOOP TESTING STARTED 






TESTING NODES : NIE HOST TO N4 


NIE>run looppair 


RUN LOOPPAIR STARTED 


ESTING : 
TESTING NODES: NIE HOST TO N4 


NTE>run pattern 


;CCITT 512 bit test pattern 


HHA og 157427, 031011, 047321, 163715, 105221 


014116, 052606, 172334 


142304, 040041, 
ee 1g 531. 111337, 111523, 030030 


. 145064 
063617, 135075, 066730, 026575 


1 
sauees’ ot rs ff 070071, 151172, 165044, 031605 


TO NIE HOST -- RESPONSE OK 
TO NIE HOST -- RESPONSE OK 
TO NIE HOST -- RESPONSE OK 
TO NIE HOST -- RESPONSE OK 


TO Ne TO Ni TO NIE HOST -- RESPONSE OK 
TO N3 TO N2 TO NIE HOST -- RESPONSE OK 
TO N4 TO N3 TO NIE HOST -- RESPONSE OK 
TO Ni TO N4 TO NIE HOST -- RESPONSE OK 


i 
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STARTING ASCII 


PASS 1 

TESTING NODES: 
TESTING NODES: 
TESTING NODES: 
TESTING NODES: 


STARTING ONES 





TESTING NODES: 
etc 


NIE>run all 





TESTING NODES: 





RUN ALL STARTED 





NODE N2 





TESTING NODES : 


PASS i 
TESTING NODE N3 
TESTING NODES: 


PATTERN TEST 
NIE HOST TO Ni 
NIE HOST TO N4 

PATTERN TEST 
NIE HOST TO Nil 
NIE HST TO N2 

TO N 
NIt HOST TO N4 


WwW 


NIE HOST TO Ni 
NIE HOST TO N2 
NIE HOST TO N3 
NIE HOST TO N4 


NI 
NIE HOST TO N4 


HO Ne 
NIE HOST TO N4 


WITH REMAINING 


NIE HOST TO N3 


WITH REMAINING 
HOST TO Ne 


10 NIE HOST -- RESPONSE 


TO NIE HOST -- RESPONSE 








RRRR 


m 
RRRR 





TABLE ENTRIES 
TO Ne T 


0 O NIE HOST 
TO Ni TO NIE HOST 
TO TO NIE HOST 
TO N1 TO NIE HOST 
TO N4& TO NIE HOST 
TO Ni TO NIE HOST 


es | ENTRIES 


TO Ne TO NIE HOST 
0 N4 TO NIE HOST 
TO Ne TO NIE HOST 


TABLE ENTRIES 
TO N4 TO NIE HOST 





RESPONSE 


SS ee - 
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74 Pp 15 
ie " 
pe TESTING NODES: NIE HOST TO N4 TO N3 TO NIE HOST -- RESPONSE OK 

746 

747 

748 4.9 BOUNCE 

1 

751 The Bounce command allows the operator to select the path for sending a 
752 packet from the NIE host, thr the NI then back to the host. The nodes 
753 identified in the command will sequentially placed into the data field 
754 of the packet with the forward command. The nodes may be specified by 
755 physical or logical addresses. The NIE host node should not be included 
756 in the node list for the Bounce command. The results of the BOUNCE 
Le H command have no effect on the Summary log. The format is: 

Le 4 NIE>bo[unce] addri,addr2...,addrn 

761 The limit on the number of nodes to which the packet can be forwarded is 
76 related to the remaining size of the data field. This command is useful 
5 for testing across repeaters or quickly testing endnodes. 

765 

766 

767 

768 4.10 MESSAGE 

83 

771 The Message command allows the operator to change the defa - paramaters 
i of message type, message size, and message number. The Format is: 

7 NIE>m[essage] /ty[pe]=asci i/s{ize)=n/clopies]=n 

776 The message size will be variable, between 46 and 1500 bytes. Mess 
777 size is defined as the size of the packet data field and excludes t 
a source, destination, packet type and CRC fields. 

780 The message copies is the number of times the message is to be transmitted 
781 and is a posative integer. A -1 indicates that packets are to be looped 
i continuously. Default is 1. 

784 

785 

786 

787 4.11 NODES 

189 

790 The Nodes command is used to allow the operator to enter nodes for testing 
Bt into the current node table. The format is: 

Le NIE>nodes addri.addr2,...,addrn 

795 The addr argument is the physical address of the node on the NI. The NIE 
7% will assign a logical address for each entry in the current node table. 


797 | Duplicate nodes may be added in this manner although the NIE assigned 


—— o—e mr ee 
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3 





238 


logical addresses will always be unique. 


° 


4.12 PRINT/NOPRINT 


SeesaE2 








810 The PRINT command causes all errors to generate error messages which are 
811 output to the operator. If the NOPRINI command is issued error papert ine 
812 stops after the first five errors. In both cases the Summary log wil 

813 continue to be updated. The PRINT and NOPRINT commands have no arguments 
814 and the default_is PRINT. The command stays in effect untill changed by 
aia the operator. The print status is displayed via the SHOW MESSAGE command. 
ate 

819 

820 4.13 NOHOE/HOE 

8 


NIE >noh[ oe) ; Do not halt on error 


or 
NIE >hoe ; Halt on error (DEFAULT) 


Halt on Error (HOE) causes the current RUN to halt when an error is 
encountered inspite the pass count. The NO Halt on Error will cause the 
run to run to completion inspite of errors. 


4.14 SUMMARY 


The Summary command prints the summary message of conditions and errors as 
a result of testing. Summary information is obtained by typing Summary 
when the NIE is running. There are no switches or qualifiers for the 
summary c . 


NIE>su[mmary ] 


4.15 CLEAR 


The Clear command will have three arguments, node, message and summary. 
The format is: 





— EE ee —— 





i 
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857 P 7 
83 ™* 
859 

860 

$6} NIE>c{lear) <argument> 

863 The Clear Node/Addr will remove e node from the node table. The node may 
864 be specified by either its physical or logical address. OPTIONALLY some 
865 implementations may allow a list of physical and logical addresses to be 
oes specified. 

o68 The “Cllear] N{ode)/A{11)" will clear the entire node table. 

870 The “Cllear) Mlessage)” will reset the message paramaters to the default 
ef state. 

a73 The “C{lear) Sulmmary]"” command will clear the node summary table. 

875 

876 

877 

878 4.16 IDENTIFY 

879 

880 





The Identify command wih) p garters a request ID to the physical or logical 
address included in command line. The resulting data will then be 
displayed. 

The format is: 

NIE>il{dentify] <address> 

EXAMPLE: 
NIE>identify 00-04-00-00-00-bc 
NODE CURRENT ADDRESS: 00-04-00-00- 
NODE DEFAULT ADDRESS: 00-00-AB-00- 


RECEIPT NUMBER: 
A al at VERSION: 03 


00-8C 
00-0C 









DEVICE 
OR, using a logical node name - 
NIE>identify NS 


NODE CURRENT ADDRESS: 00-04-00-00-00-BC 
eT AULT ADDRESS: 00-00-AB-00-00-0C 


T NUMBER: A045 
MAINTENANCE VERSION: 03 
ECO: 00 
alg USER ECO: 00 
91 FUNCTION VALUE 1: 05 
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FUNCTION VALUE 2: 00 
DEVICE: O1 
4.17 SUMMARY 
A log of events is maintained Gricn am comand processing. These 
statistics caN be displayed with the SUMMARY command 
NIE>su[mmary ) 
NODE RCV NOT RCV LENGTH COMPARE BYTES NUMBER BYTES 

COMPLETED COMPLETED ERRORS ERRORS COMPARED TRANSFERED 
00-04-00-00-00-10 0 10 1 1 2000 2000 
00-04-00-00-00-11 0 10 1 2000 
00-04-00-00-00-12 0 10 1 1 2000 2000 
00-04-00-00-00-13 0 10 1 1 2000 2000 


3.0 ERROR MESSAGES 


COMMAND OR SWITCH NOT IMPLEMENTED 
Command or switch is an optional NIE function. However, this 
implementation does not support the command. 


COMPARE ERROR - BYTE EXPECTED = XXX, BYTE RECEIVED = YYY 
This error is displayed when the data sent in a loop message does not 
match the data received in the response message. 


INVALIO COMMAND 
Invalid or syntactically incorrect command given. 




















954 
INVALIO COUNTER DATA 
956 SHOW COUNTERS error message when runn under DECnet. The format of 
$38 the counter data received from "bene is incorrect. Internal program 
error. 

9 
960 INVALID DISK NAME . 
961 by me Dee Bi thas F to accessed the specified disk. The disk does not exist 
be 4 £ preteen Enter correct device name. 
96 INVALID® ETHERNET VICE NAME 
964 NX: and XE: are we wey aypernet devices possible with this version 
965 of the NIE. NX: Cnet present and runni XE: device uses 
+ +. : the stand alone RSX 10 "SEUNAZDELU Driver. You must use one of these 
968 INVALID HEX CHARACTER ee 
hs Character specified is not a Hex digit. 
971 INVALID MESSAGE SIZE 
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Maximum message size on a non-DECnet system is 1498(10). Maximum 
message size on a DECXnet system is the same as that used by OECnet. 


INVALID MESSAGE TYPE 
type specified is not valid. 


INVALID NODE ADDRESS 
Node address as specified is invalid. Node address specified must be a 
oe s re or a o tog cal node number. 
00-02 or Nxxx (where, Nxxx is logical node number 
enolqned by ONES 


INVALID OPTION 
Option specified is invalid. 


INVALID PASS NUMBER 
The pass switch specified with one of the RUN command is invalid. Max 
pass is i100. 


INVALID PROGRAM PARAMETER - NOT ENOUGH BUFFERS 
The number of receive buffers is a hard wired program parameter. This 
message is given if this parameter is incorrect. 


INVALID PROGRAM PARAMETER - INVALID BUFFER SIZE 
If no mass stor media is being used, the giniows buffer size is 514. 
bytes (disk buffer size plus link word). hig maver size is hard 
wired into the program. This should not couaalis 


NIE ; Sere 
t what it says. 


27??? NODE ENTRIES ADDED TO NODE TABLE 
UNSAVE indicates the number of node entries added to the node table. 

















NODE NOT FOUND 
Node number specified (logical or hex) was not found in the node table. 
The command requires a address which is in the node table. 


— TABLE EMPTY 
A command was given pot requires that the Node Table be not empty. No 
further action is taken 


NODE TABLE FULL 
Indicates the NIE was unable to add an entry to the node table. i.e. - 
BUILD, UNSAVE, or adding new entries to the node table (NODE...). 


NO NODES SPECIFIED ; 
C AO. aia a node address to be specified. (i.e. CLEAR 














NODE /” 


NUMBER OF COPIES INVALID : ; 
Number of c copies specified is not valid. Currently Max of copies is 
set at 10, 


NE 
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NOT ENOUGH NODES IN NODE TABLE FOR “LOOPPAIR” OR “RUN ALL” COMMANDS 
There must be at least 2 node entries in the nodetable to RUN LOOPPAIR 
or RUN ALL commands. 


NOT ENOUGH RECEIVE BUFFERS AVAILABLE 
Internal program error. The NIE has lost track of it's recieve buffers. 


OPEN ERROR ON NIE SAVE FILE 
The user attempted to do A SAVE command but NIE was unable to create a 


save file. 

RESPONSE OK 
This Soasege indicates that the response expected by the NIE was 
eure y the NIE and that the test data returned was verified to be 
correct. 


PROGRAM ERROR - NO BUFFERS AVAILABLE 
This message should not be seen Curing normal operation. The NIE does 
some internal buffer Panggenens for send and receive messages. the 
buffer manager is out of buffers and the NIE is unable to continue the 
requested operation. 


READ COUNTERS REQUEST TO DECNET FAILED 
ead counters request to DECnet failed. This is an internal error for 
SHOW COUNTERS request. 


RECEIVE DECNET COUNTERS FAILED 
Receiving DECnet counters failed. This is an internal error for SHOW 
COUNTERS request. 











SET CHARACTERISTICS FAILED 
This segreee indicates that the set cheracteristics QIO has been 
vopews This would occure if two NIEs were to run on the same system 
each would try to select the same protocol/address pairs. 





If only one NIE is being run, then this error is an internal program 
error. 


TEXT NOT DEFINED OMMAND IGNORED 
pores /TYPE=TEX WAS togh i ating the text. Do MESSAGE 
TEXT =x xyz is a_ st ascii c enweres to define the text 
string sass issuing MESSAGE® /TYPE=TEXt command 


TIME OUT - REMOTE NODE NOT RESPONDING 
This message is displayed — the NIE wait time expires while uatticg 
for a response from a remote node. All the Sanger iy! ty commands wil 
result in this message if the remote node being te 
responding. 


During a RUN command execution, this message indicates that the node(s) 
being tested are displayed in the message on the previous line. 


TRANSMIT ERROR - COMMAND TERMINATED 
This error message only indicates that there has been an error when the 

















sted is not. 


ree ee ee ee it 
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1090 

1091 NIE has ettengves to transmit a message. It does not indicate what the 
1092 error was ransmission errors are caused by some hardware 
1093 malfunctioning. When running under DECnet an error "lee message on the 
sos console may indicate what the error was. 

1096 UNABLE TO OBTAIN LOCAL ADDRESS FROM ETHERNET DEVICE DRIVER 

1097 This message may be received in a non-DECnet evironment only. At 
1098 initialize time NIE tries to read the current physical address of the 
1099 Ethernet device. This is needed for source address determination. 

1100 source address is used in MOP messages to specifiy return address of 
+195 responses. This is a driver/system error. Should not normally occ:re! 
1103 UNABLE TO OPEN ETHERNET PORT 

104 This message indicates that the RSX QIO Driver is not present or that 


uw 


OO ee he he he he he pe be fe pe 2 he pt pe be pe pe Fe be be he pe bt be pe pe be bo pe pe fe po po pe po 
Ci Gt Ul GSN ON ON CAPO FO FOO FU Ro ro fo ron> 
OU bUshore OOS Oe 


ee ed el ed oe ee ee eo reo 


SPoaPaw 
Wwtr Ow 





Cif runni with DECnet) DECnet is not up and naming, The error may 
also indicate that the Ethernet device cannot be initialized. 


UNABLE TO OPEN SAVED NODE TABLE FILE 
UNSAVE command is unable to open saved node table file. 


UNABLE TO READ COUNTERS FROM DEVICE 
NIE was unable to read counters from non-CECnet driver. This is an 
internal program error. 


UNABLE TO READ SAVED NODE TABLE FILE 
UNSAVE command is unable to read saved node table file. 


UNABLE TO READ WORK FILE 
If the user specified a disk to be used at initialize time, NIE will 

create a temporary fet file) file on that disk for it’s node table. 

An error while trying to read this disk will produce the above message. 


a TO TALK DECNET 
i ae ¢ an occure while doing a SHOW COUNTERS command when runni 
DECnet. The NIE is trying to create a Network Data Queue 
faries. This bee be caused by system resources not available or DECnet 


iS going 






























6.0 COUNTERS INTERPRETATION 


DELUA/DEUNA Counter Specification: 


The counter values are unsigned integers. Counters latch at their maximum 
values to indicate overflow. 


Seconds Since Last Zeroed - 
16 bits for the number of seconds since the counters were last zeroed. 


Packets Received - 
32 bits for the total number of datagrams received error free. 


——— eee ee 
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47 
ti Multicast Packets Received - 
ites 3 bits for the total number of cmulticast datagrams received error 

ree. 

1151 
1152 Packets Received with Error - Sitnep - 
1153 1. Bit <00> - CRC. Block Check Error - A datagram failed the CRC 
13s check. 
1156 2. Bit <O1> - FRAM. Framing Error - A datagram failed the CRC 
tee check and did not contain an integral multiple of 8 bits. 
1159 3. Bit <O2> - MLEN. Message Length Error - A datagram was larger 
+360 than 1518 bytes. 
116¢ 4. Bits <15:03> = 0. 
116 
1164 
1165 Packets Received with Error - 
1166 6 bits for the total number of datagrams received with one or more 
1167 errors logged in the bitmap. Includes only datagrams that passed 
1188 destination address comparison. 
1170 Data Bytes Received - 
1171 S2 bits for the total number of data bytes received error free, 
Ai t¢ exclusive of data link protocol overhead. 
1174 Multicast Bytes Received - 
1175 32 bits for the total number of multicast data bytes received error 
i176 free, exclusive of data link protocol overhead. 
1178 Receive Packet Lost - 
1179 Internel Buffer Error - 16 bits for the total number of times there was 
1180 e discard of an incoming packet due to lack of internal buffer space. 
138} Incoming packets must be error free to be counted. 
1183 Receive Packet Lost - 
1184 Local Buffer Error - 16 bits for the total number of times there was a 
1185 problem with a receive ring data buffer. This counter is incremented on 
1386 one of more of the following occurences. 
1188 1. Buffer Unavailable - A datagram was lost because there was no 
1333 available buffer on the receive ring. 
1191 2. Buffer too Small - A datagram was truncated because it was 
1338 larger than the available buffer space on the receive ring. 
1194 Packets Transmitted - 32 bits for the total number of datagrams 
1195 successfully transmitted, including transmissions in which the collision 
i199 test signal failed to assert. 
1198 Multicast Packets Transmitted - 
1199 32 bits for the total number of multicast datagrams Syocsserul ty 
1200 transmitted, including transmissions in which the collision test signa 
1201 failed to assert. 


a . a 


CZNIA 
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3e ods ps oe - 32 bits for the total number of datagrams , cucoqoot ut ty 
e 


transmi 


d on three or more attempts, including transmissions in whic 


the collision test signal failed to assert. 


Packets Transmitted - 
2 Atten 
transmitted 





two a 


on t 
collision test signal fai 


Packets Transmitted - 





ts - 32 bits for the total number of 


t ts, 
led to assert. 


ine 


Deferred - 32 bits for the total 


transmitted on the 


irst 


attemp 


datagrams successfully 
luding transmissions in which the 





number of dat 


ams successfully 
t after 


deferring, including 


transmissions in which the collision test signal failed to assert. 


Data Bytes Transmitted - 
32 b 


exclusive of data Link 
generated retransmissions 
collision test signal fai 


Multicast Bytes Transmitted - 
totel 











t 
led to 








ine 


its for the total number of data bytes successfully transmitted, 
rotocol overhead ard not counting date 
luding trarenissions 


link 
in which the 


assert. 








32 bits for the al number of multicast data bytes successfully 
transmitted, exclusive of data link protocol overhead and not ete 
DELUA generated retransmissions, but including transmissions in whic 
the collision test signal failed to assert. 
Transmit Packets Aborted - Bitmap - 
1. Bit <00> - RTRY. Excessive Collisions - Retry error, 16 
unsuccessful transmission attempts. 
2. Bit <O1> - LCAR. Loss of Carrier - Retry error (16 
unsuccessful transmission attempts). loss of carrier flag. 
non-zero TOR value on last attempt. 
Bit <02> - 0. 
Bit <03> - 0. 
Bit <04> - MLEN. Data Block too Long - The DELUA aborted the 
transmission process because the datagram exceeded the maximum 
packet size. 
6. Bit <O5> - LCOL. Remote Failure to defer - Late collision on 


the last transmission attempt. 


7. Bits <15:06> = 0. 
Transmit Packets Aborted - 


16 bits for the total number of Gokegrane that 
transmission for one or more of the bi 





Transmit Collision Detect Failure - 


were aborted during 
mapped errors. 





Me 
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1263 

1264 16 bits for the total number of times the opti loten test signal failed 
‘S02 to assert following an apparently suscessful transmission. 

1 

i<ee DELUA ONLY COUNTERS 

1270 PORT ORIVER ERROR - 

£271 16 bits for the total number of times the Port Driver attempts to 
127 issue another Port/Ancilliary command while one is still being 
ist; processed. 

1275 BABBLE COUNTER - 

127 16 bits counter for the total number of times the LANCE reported the 
127 babble condition on the channel. 
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APPENDIX A 
SAMPLE NIE BUILD OUTPUT 


>MOU MTO:NIE/DENS=1600 
>PIP /NV=MTO:CZNIA. SEQ 
>PRINT CZNIA.SEQ ; Print doc file for your information 








P— Rn. A file to you area 


pen iee 








7 
>PIP /NV=MTO:NIEBLO.CMD ; Copy NIE build file to your area 
1 >@NIEBLD 
i : PEEPS SSSES SSS ESE SEES ESSE eee eee eee eee SESE SEES SEES SEES E SE. 
< E: ' 
1308 >; ; This command file must be run from a privileged account as it needs ! 
1306 >; ! to some files to the SY:({1.1]) area. ’ 
>3 See ReSPRRArEeTSeeSelGPOESPSTSGEREEPEeSeegegeeeeecoeseececeuecesesess 
if 2 
309 ; The format for the input device and UIC is DEV:(XXX,YYY]. The command 


>t file does not do extensive syntex checking. Therefore, if specified, the 
. format of the device-UIC string must be correct. 


> Input device and UIC of source files [D=DRO:(6.6])] [S]): at: 
+. The format for the destination device and VIC is DEV: ~ loge? le The command 


i file does not do extensive syntex checking. Therefore, if specified, the 
; format of the device-VIC stein must be correct. 


Ped jee See pene et 








“. 


AaUAWUAUIGIUIGI UI 


ee eee 
OOO INVIPWNEHO 


(S): <cr> 


7 


eel aml al aml aL ant asl anl-anl acl onl anlaclanl ant acl nol acl eel acl aol ool sal eal ele toe 
_ 
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iss SAMPLE NIE BUILD OUTPUT Page 26 
1338 

1339 y want to bu 

1340 AS TD iy ea Th 

1341 Pp -(6,6)/NV=MTO: , 

1342 >PIP SY:{1,1]/NV=M UAMC .T 

1343 e :(6,6])/NV=MTO:LUAMC. TSK 

1344 :(6,6)]/NV=MTO: XE 

1a DRO:(6,6)/NV=MTO 





DRO: 16,6)/NV=MTO: UML .MAC 
>MAC @DRO:(6,6]XEDRVASM.CMD 

















1347 
ize >TKB @DRO:(6,6]XEDRVBLD.CMD 
>; 
1350 >; We have soapeated building the driver and the ECO microcode loader 
13a3 >i support task. 
1333 >; #&& NOTE se 
1354 >; If DECnet is running and is using your DEUNA or DELUA device then you 
1355 >; must not try to LOAD the XE: (DEUNA/DELUA) driver as the device Vector 
1356 >; and RSX Device Control Block are already taken and this will cause an 
aes >; error. 
>; 
1359 >; However, if DECnet is not nunning and you wish to use the the RSX QI0 
1360 >; DEUNA/DELUA driver (XE: Driver) then you can have this command file 
pre: >; load it for you. at this time. 
>; 
1363 >* pe yew want to LOAD the XE: (DEUNA/DELUA) driver? Y 
1364 >REM Gace 
1365 
1366 ; RSX-11M 
1367 
1368 >LOAD XE: /PAR=GEN/HIGH 
1369 >INS DRO:(6,6]UML 
1370 
1371 
1372 ; RSX-11M-PLUS 
1373 
1374 >INS $CON 
1375 >LOAD XE:/PAR=GEN/HIGH 
1376 >CON SET XEA VEC=120 CSR=174510 
1377 >CON ONLINE XEA,XEO: 
1378 >INS DRO: (6,6 ]UML 
1379 
1380 >a <EOF> 
1381 t 
1382 000001 . END 





To 


CS 
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SYMBOL TABLE 
Page 27 
. ABS. 000000 
000000 
ERRORS DETECTED: 0 
VIRTY MEMORY USED: 29 WORDS ( 1 PAGE 
NAMIC HE MORY Re ( 78 PACES? 
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